v1.31.0

API

Incubator

• Refactor advice API to simplify usage
  (#​5848)

SDK

• BatchLogRecordProcessor and BatchSpanProcessor unify queueSize metric
  description and attribute name for processorType
  (#​5836)

Metrics

• Allow instrument names to contain a forward slash
  (#​5824)
• Memory Mode support: Adding memory mode, and implementing it for Asynchronous Instruments
  (#​5709,
  #​5855)
• Stabilize MetricProducer, allow custom MetricReaders
  (#​5835)
• Drop NaN measurements to metric instruments
  (#​5859)
• Fix flaky MetricExporterConfigurationTest
  (#​5877)

Logs

• Add addAllAttributes() to ReadWriteLogRecord.
  (#​5825)

Exporters

• Prometheus exporter: handle colliding metric attribute keys
  (#​5717)

SDK Extensions

• File configuration ConfigurationReader handles null values as empty
  (#​5829)

Semantic conventions

• BREAKING: Stop publishing io.opentelemetry:opentelemetry-semconv. Please use
  io.opentelemetry.semconv:opentelemetry-semconv:1.21.0-alpha instead, which is published
  from open-telemetry/semantic-conventions-java.
  The new repository is published in lockstep
  with open-telemetry/semantic-conventions.
  (#​5807)

Project Tooling

• Add Benchmark workflows
  (#​5842,
  #​5874)
• Add clearer docs around coroutine support with an example
  (#​5799)

v1.30.1

• Fix autoconfigure bug creating multiple PrometheusHttpServer instances with same port
  (#​5911)

v1.30.0

API

Incubator

• Add experimental synchronous gauge
  (#​5506)

SDK

Metrics

• Add attributes advice API
  (#​5677,
  #​5722)
• Add AttributesProcessor toString, add attribute filter helper
  (#​5765)
• Increase metric name maximum length from 63 to 255 characters
  (#​5697)

Exporter

• Prometheus exporter: remove non-ucum units from conversion
  (#​5719)
• Prometheus exporter: add units to metric names in TYPE and HELP comments
  (#​5718)

SDK Extensions

• Add support for file based configuration to incubator
  (#​5687,
  #​5751,
  #​5758,
  #​5757,
  #​5755,
  #​5763,
  #​5766,
  #​5773,
  #​5771,
  #​5779)
• Autoconfigure ConfigProperties#getMap filters entries with blank values instead of throwing
  (#​5784)

Semantic conventions

• DEPRECATION: io.opentelemetry:opentelemetry-semconv is deprecated for removal. Please use
  io.opentelemetry.semconv:opentelemetry-semconv:1.21.0-alpha instead, which is published
  from open-telemetry/semantic-conventions-java.
  The new repository is published in lockstep
  with open-telemetry/semantic-conventions.
  (#​5786)

Project Tooling

• Update Gradle Wrapper from 8.2.1 to 8.3
  (#​5728)
• Remove dependabot and update-gradle-wrapper task in favor of renovate
  (#​5746)

v1.29.0

API

• Update Span javadoc to allow null/empty attr values
  (#​5616)

SDK

• Add Sdk{Signal}ProviderBuilder#addResource(Resource) method to merge Resource
  with current
  (#​5619)

Metrics

• Add LongHistogramAdviceConfigurer to improve api surface types
  (#​5689)
• Instruments with names which are case-insensitive equal contribute to same
  metric, advice is not part of instrument identity.
  (#​5701)

Exporter

• Add OtlpHttp{Signal}Exporter#toBuilder() methods
  (#​5652)
• Add OtlpGrpc{Signal}Exporter#toBuilder() methods
  (#​5680)
• Add #toString to OTLP exporters
  (#​5686)
• Break out GrpcSender, GrpcSenderProvider
  (#​5617)

SDK Extensions

• BREAKING: Delete zpages
  (#​5611)
• Initialize file configuration with generated model classes and parse method
  (#​5399)
• Refactor SpiUtil to improve mocking
  (#​5679)
• Switch from snakeyaml to snakeyaml engine
  (#​5691)
• Add experimental autoconfigure support for customizing cardinality limit
  (#​5659)
• Reorganize autoconfigure docs by signal
  (#​5665)

Testing

• Add hasResourceSatisfying to LogRecordDataAssert
  (#​5690)

OpenCensus Shim

• Change OpenCensus shim default sampling to defer to OpenTelemetry
  (#​5604)

Project Tooling

• Update Gradle Wrapper from 8.2 to 8.2.1
  (#​5618)
• Fix gradle java version requirement warning
  (#​5624)
• Refer to Adoptium/Temurin instead of AdoptOpenJDK
  (#​5636)
• Use OtelVersionClassPlugin instead of reading version from resource
  (#​5622)
• Enforce build-graal success in required status check
  (#​5696)

v1.28.0

opentelemetry-sdk-extension-autoconfigure is now stable! See "SDK
Extension" notes below for changes made prior to stabilization.

SDK

Metrics

• Make Advice proper immutable class
  (#​5532)
• Show attributes when async instruments record duplicate measurements
  (#​5542)
• After cardinality limit exceeded record measurements to overflow series
  (#​5560)

Exporter

• Add HttpSender abstraction with OkHttp implementation
  (#​5505)
• Add HttpSenderProvider SPI
  (#​5533)
• Add JDK 11+ HttpClient HttpSender implementation
  (#​5557)
• Remove unnecessary :exporter:otlp:common dependencies
  (#​5535)
• Fix OTLP exporter artifact name in an error message
  (#​5541)
• Stabilize RetryPolicy API for OTLP exporters
  (#​5524)
• DEPRECATION: opentelemetry-exporter-jaeger and opentelemetry-exporter-jaeger-thrift are now
  deprecated with the last release planned for 1.34.0 (January 2024)
  (#​5190)

SDK Extensions

• Mark opentelemetry-sdk-extension-autoconfigure as stable
  (#​5577)
• Refactor autoconfigure registerShutdownHook(boolean) to disableShutdownHook()
  (#​5565)
• AutoConfiguredOpenTelemetrySdkBuilder does not set GlobalOpenTelemetry by default
  (#​5564)
• Add public API to autoconfigure to access environment resource
  (#​5554)
• Move autoconfigure getConfig to internal, remove getResource
  (#​5467)
• Add autoconfigure support for low memory metric temporality setting
  (#​5558)
• DEPRECATION: zpages extension from opentelemetry-sdk-extension-incubator
  is now deprecated
  (#​5578)

Project tooling

• Publish build scans to ge.opentelemetry.io
  (#​5510)
• Update Gradle Wrapper from 8.0.1 to 8.1.1
  (#​5531)
• Add action to auto update gradle wrapper
  (#​5511)

v1.27.0

The log bridge API / SDK are now stable! Some important notes:

• The contents of opentelemetry-api-logs have been merged into opentelemetry-api.
• The contents of opentelemetry-exporter-otlp-logs have been merged
  into opentelemetry-exporter-otlp.
• The contents of opentelemetry-sdk-logs-testing have been merged into opentelemetry-sdk-testing.
• The opentelemetry-sdk-logs artifact has been marked stable.
• opentelemetry-sdk-extension-autoconfigure has changed the default value
  of otel.logs.exporter from none to otlp.

NOTE: reminder that
the Logs Bridge API
is not meant for end users. Log appenders use the API to bridge logs from existing log
frameworks (e.g. JUL, Log4j, SLf4J, Logback) into OpenTelemetry. Users configure the Log SDK to
dictate how logs are processed and exported.
See opentelemetry.io for
documentation on usage.

API

• Promote log API to stable
  (#​5341)
• fix doc for OpenTelemetry class
  (#​5454)

SDK

• Ensure correct compiled output and sources are included in multi version jar
  (#​5487)

Logs

• Fix broken link
  (#​5451)
• Add meaningful .toString to NoopLogRecordProcessor and DefaultOpenTelemetry
  (#​5493)
• Promote log SDK to stable
  (#​5341)

Metrics

• Reset exponential aggregator scale after collection
  (#​5496)
• Experimental metric reader and view cardinality limits
  (#​5494)

Exporter

• Merge otlp logs
  (#​5432)
• Append unit to prometheus metric names
  (#​5400)

Testing

• Merge sdk logs testing
  (#​5431)
• Add a hasBucketBoundaries() variant that allows specifying precision
  (#​5457)

SDK Extensions

• Enable otlp logs by default in autoconfigure
  (#​5433)

Semantic Conventions

• Update to semconv 1.20.0
  (#​5497)